{{tag>Edgy brouillon}}

----

====== SABnzbd ======

**SABnzbd** est un logiciel très pratique pour tous les utilisateurs des newsgroups. En effet, il fonctionne en tant que démon et on peut alimenter la queue de téléchargements via une interface web ou en placant les fichiers NZB dans un dossier particulier (pratique pour alimenter //via// FTP).

===== Pré-requis =====

==== Installer quelques paquets ====

  * Activer les [[:depots#universe_et_multiverse|dépôts Universe]]
  * [[:tutoriel:comment_installer_un_paquet|Installer les paquets]] **python-cherrypy python-elementtree par2 unrar build-essential python-dev python-openssl python-cheetah**

  sudo apt-get install python-cherrypy python-elementtree par2 unrar build-essential python-dev python-openssl python-cheetah

==== Création des répertoires ====

**SABnzbd** nécessite la création de différents répertoires.

<note>Les chemins sont donnés à titre d'exemple.</note>
<note>La dernière version de SABnzbd crée un dossier download dans votre home, indépendament du dossier SABnzbd (ce qui permet d update le logiciel sans modifier ses fichier téléchargés)
vous pouvez donc passer cette étape</note>

  mkdir ~/SABnzbd
  mkdir ~/SABnzbd/downloads
  mkdir ~/SABnzbd/tmp
  mkdir ~/SABnzbd/nzb

Le répertoire **downloads** contiendra les fichiers téléchargés.
Le répertoire **tmp** contiendra les fichiers téléchargés qui n'auront pas encore été déplacés dans le répertoire final.
Le répertoire **nzb** est constamment vérifié par le démon SABnzbd et chaque fichier NZB que vous placerez à l'intérieur sera aspiré et placé en file d'attente dans la queue de téléchargement.

----

==== Installation de Yenc ====

Sous [[Hardy]] et [[Gutsy]], [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **python-yenc**

Avant Gutsy, il vous faut exécuter la manipulation suivante :

  wget http://www.hellanzb.com/hellanzb-content/yenc-0.3.tar.gz
  tar zxvf yenc-0.3.tar.gz
  cd yenc-0.3
  python setup.py build
  sudo python setup.py install

===== Installation =====

<note important>Attention aux prochaines étapes vous allez ouvrir une session terminal en mode "super user", ne faites pas n'importe quoi ! </note>

Ouverture d'une session terminal en "super user" 
  sudo -s
tappez votre mot de passe lorsqu'il vous est demandé


  cd /etc
  wget http://freefr.dl.sourceforge.net/sourceforge/sabnzbdplus/SABnzbd-0.4.8-src.tar.gz
  tar zxvf SABnzbd-0.4.8-src.tar.gz
  rm SABnzbd-0.4.8-src.tar.gz
  cd /bin
  echo /etc/SABnzbd-0.4.8/SABnzbd.py > SABnzbd
  chmod +r ./SABnzbd
  exit

sous Intrepid, il suffit que Python soit installé, on lance dans un terminal:
wget http://freefr.dl.sourceforge.net/sourceforge/sabnzbdplus/SABnzbd-0.4.8-src.tar.gz
puis, on décompresse SABnzbd-0.4.8.tar.gz, et on pourra lancer SABnzbd.py par double clic ou taper dans un terminal ./SABnzbd.py en se mettant dans le répertoire de SABnzbd (par défaut, SABnzbd-0.4.8)

  

===== Configuration =====
Le fichier de configuration liée à votre utilisateur se trouvera de votre home folder ~/.sabnzbd/sabnzbd.ini. Nous allons donc devoir créer ce fichier avec les paramètres de base les plus importants. 

  gedit ~/.sabnzbd/sabnzbd.ini

Le fichier de configuration est constitué de clés et de valeurs. Une clé est située à gauche du signe = alors qu'une valeur est située à droite.

Selectionnez le contenu suivant et copier-coller l'ensemble sous gedit. 

<file>
__version__ = 18
[misc]
log_dir = logs
auto_browser = 1
permissions = ""
check_new_rel = 1
replace_spaces = 1
fail_on_crc = 1
enable_filejoin = 1
enable_unzip = 1
enable_unrar = 1
enable_par_cleanup = 1
par_option = ""
config_lock = 0
safe_postproc = 1
pause_on_post_processing = 1
cleanup_list = ,
ignore_samples = 0
send_group = 0
download_dir = SABnzbd/temp
download_free = 500M
complete_dir = SABnzbd/done
script_dir = ""
nzb_backup_dir = ""
cache_dir = cache
dirscan_dir = SABnzbd/nzb
dirscan_speed = 5
refresh_rate = 0
rss_rate = 60
bandwith_limit = 0
cache_limit = 0
email_endjob = 1
email_full = 1
schedlines = ,
dirscan_opts = 3
dirscan_script = None
top_only = 1
auto_sort = 0
enable_tv_sorting = 0
tv_sort_string = ""
web_color = ""
web_color2 = ""
host = localhost
port = 8081
web_dir = Plush
web_dir2 = Default

[servers]
[[news-europe.giganews.com:563]]
host = news-europe.giganews.com
port = 563
username = <<Votre loggin>>
password = <<Votre Mot de passe>>
timeout = 120
connections = 5
fillserver = 0
ssl = 1
[[news.giganews.com:563]]
host = news.giganews.com
port = 563
username = <<Votre loggin>>
password = <<Votre Mot de passe>>
timeout = 120
connections = 5
fillserver = 0
ssl = 1

</file>
La partie pour la configuration des serveurs de newsgroups n'est donné qu'a titre d'exemple. Ici nous avons créé 2 serveurs giganews (Europe et USA) ayant chacun 5 connexions simultanées sur le port 563 avec un support SSL pour le cryptage du transfert.  Pour l'activation du SSL il peut être nécessaire d'installer le paquet python_openssl sinon la case de sélection reste grisée.

Dans l'exemple ci-dessous nous allons détailler le parametrage pour une conexion vers les serveurs newsgroup de chez FREE 

<file>
[servers] 
 [[server 0] <-------------------- nom du serveur
    host = news.free.fr <--------- adresse du serveur 
    port = 119 <------------------ port TCP sur lequel effectuer la connexion
    username = "" <--------------- compte client 
    password = "" <--------------- mot de passe 
    connections = 4 <------------- Nbr max de connexion
    ssl = 0 <--------------------- Crypter la connexion ? oui=1 non=0
    fillserver = 0
</file>



===== Utilisation =====


==== Démarrage ====

Le lancement de **SABnzbd** se fait via un terminal :

  SABnzbd

Vous devriez maintenant pouvoir vous connecter à l'interface web disponible à cette adresse : http://localhost:8081/sabnzbd.

Pour lancer **SABnzbd** au démarrage de Gnome/Ubuntu :

Allez dans //Système -> Préférences -> Sessions -> Programmes au démarrage//

Ajoutez :

  python /etc/SABnzbd-0.4.5/SABnzbd.py -f ~/.sabnzbd/sabnzbd.ini -d

===== Création d'une entrée dans le menu =====

une entrée dans votre menu applications⇒ internet

   * Création du lien dans le menu

[[http://doc.ubuntu-fr.org/tutoriel/comment_editer_un_fichier|éditez ou créez le fichier]] /usr/share/applications/SABnzbd.desktop et copiez-y ceci :

<code>

[Desktop Entry]
Name=SABnzbd
Comment=Grabber Pour Newsgroup
Exec=/etc/SABnzbd-0.4.5/SABnzbd.py
Icon=/etc/SABnzbd-0.4.5/interfaces/iphone/templates/static/apple-touch-icon.png
Terminal=false
Type=Application
Categories=Application;Network;
StartupNotify=true

</code>





vous pouvez maintenant accéder à SABnzbd depuis le menu application⇒ internet





==== Ajouter un téléchargement ====

Vous pouvez ajouter un téléchargement via l'interface Web de trois façons.
 
  - Soit via une URL pointant vers le fichier NZB (champ **Add URL**).
  - Soit en cliquant sur le bouton « Parcourir » et en sélectionnant sur votre disque dur le fichier NZB à envoyer.
  - Mais le top du top  c'est que l'on peut placer les fichiers NZB dans «~/SABnzbd/nzb » et les téléchargements seront automatiquement démarrés. C'est pratique pour lancer des téléchargements en masse par FTP.



^ Valeur ^ Actions ^
| None   | SABnzbd se contentera de télécharger votre fichier et n'effectuera aucune action. |
| Repair | SABnzbd réparera si besoin vos fichiers. |
| Unpack | SABnzbd effectuera l'opération //Repair// puis décompressera vos fichiers s'il sont compressés au format ZIP ou RAR. |
| Delete | SABnzbd effectuera les opérations //Repair// et //Unpack// puis supprimera de votre disque dur les fichiers temporaires (*.rar, *.zip, *.par2) et ne gardera que les fichiers décompressés. |

===== Références =====

  * [[http://sourceforge.net/projects/sabnzbd/|Site Sourceforge]] (en)
  * [[http://www.teletuto.fr/story.php?title=SABnzbd_installation_et_configuration-1|Tutorial vidéo]] (fr) 
------
//Contributeurs : [[utilisateurs:n3k]], [[utilisateurs:Di@bl@l]], [[utilisateurs:Cybermanu]], [[utilisateurs:ddorion]]//